home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / docs / howto / understandX11R5 < prev    next >
Encoding:
Text File  |  1992-12-14  |  3.0 KB  |  100 lines
  1.  
  2. This document describes how to port X11R5 to sprite.  It is also
  3. intended to help in maitaining X11.
  4.  
  5.  
  6.         1. Intro
  7.  
  8.     2. How to compile X
  9.  
  10.     3. How to make changes to X
  11.  
  12.     4. How to port a new version of X
  13.  
  14. =========================================================================
  15. 1. Intro
  16. ==================================
  17.  
  18. If you have not already done so, you should read the release notes in
  19. mit/RELNOTES.TXT.  There is a lot of good information about how to
  20. compile X.
  21.  
  22. The X sources are available via anonymous ftp from export.lcs.mit.edu.
  23.  
  24. =========================================================================
  25. 2. How to compile X
  26. ==================================
  27.  
  28.     Make World
  29.  
  30.         This will remake all the Makefiles (using imake), generate
  31.     dependencies, clean out all the object files, and then recompile
  32.     everything from scratch.
  33.  
  34.     Make Everything
  35.  
  36.         This will recompile everything that is out of date.
  37.  
  38.     Make install
  39.  
  40.         This will install everything in the directory  $(DESTDIR)/usr/X11R5.
  41.     To install everything in the normal places, run
  42.  
  43.             make DESTDIR=/ install
  44.  
  45.     /usr/X11R5 is a symbolic link to /X11/R5.
  46.  
  47. =========================================================================
  48. 3. How to make changes to X
  49. ==================================
  50.  
  51. X does not use pmake, it uses imake instead.  So if you need to change
  52. the compiler flags or reconfigure the way it is compiled, then you need
  53. to check out the files in /X11/R5/mit.$MACHINE/config.  Most of these
  54. files are symbolic links to /sprite/lib/imake.
  55.  
  56. Be careful when you change things in /sprite/lib/imake because there
  57. are other programs besides X that use imake.
  58.  
  59. The X sources contains about 50 gazillion files, so to make it easier
  60. to find a particular file, there is a list in the top directories called
  61. file.lst.  You can grep through it to find a particular file.  If this
  62. file does not exist, you can recreate it by running
  63.  
  64.     find /X11/R5/mit.$MACHINE -print > /X11/R5/mit.$MACHINE/file.lst
  65.  
  66. Each of the root X source directories contains an ID file, so you can
  67. find variable names using lid, gid, etc.  You can recreate the ID
  68. database using this command:
  69.  
  70.     find . -name '*.[ch]' -print | mkid -v -
  71.  
  72. The master sources for X11R5 are in /X11/R5/mit.  Do not change anything
  73. in the master sources.  For each machine type there is a tree of symbolic
  74. links that point to the master sources.  If you need to make any changes,
  75. to a file, you should replace the link with a copy of the file, and then
  76. edit it.
  77.  
  78.  
  79. =========================================================================
  80. 4. How to port a new version of X to Sprite.
  81. ==================================
  82.  
  83. The X sources are available via anonymous ftp from export.lcs.mit.edu.
  84.  
  85. ./server/os/connection.c
  86.  
  87.         Sprite Pdevs
  88.  
  89. ./server/os/io.c
  90.  
  91.         Sprite Pdevs
  92.  
  93. ./server/os/osinit.c
  94.  
  95.         Use /dev/syslog for X error messages.
  96.  
  97. =========================================================================
  98. =========================================================================
  99.  
  100.